QuickDraw 3D - TextureEyes For Windows

TextureEyes is a QuickDraw 3D application for illustrating how pictures can be 
applied to 3D objects.  You can select from a simple set of 3D objects in the 
palette or drag more complex 3DMF files into the window and manipulate them to 
view them from any position.

This application also demonstrates what's possible with the standard toolbox 
routines from the QuickDraw 3D and QuickTime system extensions.

* System Requirements *
This application is designed for Windows 95 and NT with QuickDraw 3D.

* Exploring TextureEyes *
To begin select one of the geometry models in the Geometry Palette or open a 
3D model file in 3DMF format with the Open command to view more complex 3D 
models. The built-in geometries in the Geometry Palette are trigrid, box and 
conic and quadric geometries.  The conic and quadric geometries (torus, ellipsoid, 
cone, and cylinder) can be substituted with similar looking representations based
 on trigrid geometries.  See the end of this document for more information on this.

* 3DMF File Drag and Drop *
A simple way to view other 3D models is by dragging 3DMF files directly from the 
Finder into the application's window.  The button in the Geometry Palette with 
the 3DMF document icon highlights to show the model was imported.  Note that if 
you wish to apply textures to the model the imported model must have UV parameter 
information.

* Texture Menu *
The Texture menu lets you select the type of texture applied or mapped onto objects.

You can apply different pictures onto an object's surface by choosing the Picture 
item under the Texture menu.  TextureEyes comes with a built-in set of picture 
textures.  Some of the pictures produce very realistic looking results, especially 
on more complex models. 

The Geometry and Face menu options determine whether a texture is mapped across 
the entire geometry or on the smaller facets of the geometry's surface.  Note the 
Geometry selection has no effect with the built-in box and skewed box geometries.  
Also, for many of the other built-in geometries the QD3D 1.5 Conics item should 
be checked.  Conics and quadrics are only available with versions of QuickDraw 3D 
1.5.

* View Menu *
The View menu has options for changing the scene's overall appearance and 
controls for changing the geometry and window background colors.

Choosing the Subdivision item brings up a dialog to let you to choose between 
Constant, World Space, Screen Space subdivision methods.  The U and V fields 
control the number of subdivisions in each direction for the subdivision methods.  
You can clearly see how subdivision works by choosing the Wireframe renderer.

The Background Color option changes the window's background color.

The Auto Rotation menu item lets you stop and start the model from spinning 
continuously if is has been set in motion after clicking and dragging inside 
the window.  Another way to stop the model from rotating is to click once in 
the window without moving the mouse.

* Settings Menu *
The Settings menu has general options for showing and hiding the main Geometry 
and Paint Palettes.

The main Geometry and Paint Palettes can be shown and hidden from the Settings menu.  
The first eleven buttons are the geometry buttons plus the last button which represents 
any models imported into TextureEyes.  The last four buttons at the top of Geometry 
Palette control how the object is manipulated when the cursor is clicked and dragged 
inside the window.  These object tools are the Rotation, Scale, Move, Zoom, and 
Home buttons.

The Paint Palette and Change Brush menu items are only available with QuickDraw 3D 
version 1.5 or later.  The Paint Palette provides a basic set of paint colors.  
Below these are various brush shapes with an eyedropper and eraser.  The eyedropper 
picks up the color of the texture beneath the brush and substitues it for the color 
in last color button.  This is used to  pick up a specific color in a texture and 
blend it across neighboring areas in the texture.  Using the eraser restores texture 
with the original pixel colors.  Painting currently does not work on models imported 
into TextureEyes that already have textures.

If the Change Brush item is active this presents a dialog for selecting how the paint 
is applied: Solid, Feathered, and Blended.  Choosing solid applies the paint for the 
entire the shape of the brush.  Feather softens the application of the paint near the 
edges of the brush's shape.  Blend mixes the paint's color with the colors of the 
texture as it's applied.  You can also have a visible Line or Pencil at the point 
where the paint meets the surface of the geometry.  The Pixel Spacing and Minimum 
Spacing control the rate at which the paint is applied.

When the Paint Palette is visible 3 modifier keys can be used to help you with your 
painting.  These have an effect when the key is held down and the mouse is pressed 
within the window.  The control key temporarily switches to the current tool for 
manipulating the object.

To find out more about QuickDraw 3D visit the Apple web site:

	http://www.apple.com/quicktime/qd3d/